home *** CD-ROM | disk | FTP | other *** search
/ Acorn RISC PD-CD 1 / Acorn RISC PD-CD 1.iso / utilities / _dtp / dtp / _impcompr / _help < prev    next >
Encoding:
Text File  |  1992-09-23  |  5.1 KB  |  121 lines
  1.  
  2.                                Impression Compress
  3.  
  4.                          Copyright © Jonathan Marten 1992
  5.                         Version 1·00, 22nd September 1992
  6.  
  7. Introduction
  8. ------------
  9.  
  10. This utility, used in conjunction with SparkFS, will get around (with
  11. limitations) one of Impression's most annoying features — storing documents
  12. in an application directory.  Although convenient for Computer Concepts'
  13. programmers, the complex structure takes up a lot of space on disc
  14. (especially for hard disc users);  also, if the document is copied or
  15. renamed it will lose its distinctive sprite.  Copying it is also very slow…
  16.  
  17. ImpCompr stores the document in a SparkFS archive, with its own file type
  18. and an icon that looks something like the Impression document icon.  Within
  19. the archive, the document's application directory is stored in the normal
  20. Impression format: some of the files there (e.g. !Sprites) are superfluous,
  21. but are retained for simplicity.  As well as the space saved by eliminating
  22. the subdirectories, SparkFS's normal compression helps to reduce the file's
  23. size to usually about half of that taken up by the uncompressed document.
  24.  
  25. When a file of this type is run, a small Basic program is executed which
  26. converts the file name into a SparkFS archive pathname, finds the name of
  27. the document file within the archive and renames it, if necessary, so that
  28. Impression's window title is correct.  It then runs the document directory
  29. from inside the archive:  any subsequent saves write directly back to the
  30. archive.
  31.  
  32.  
  33. Compressing documents
  34. ---------------------
  35.  
  36. To compress documents, ensure that SparkFS is loaded.  Then run the
  37. !ImpCompr application, which will install itself onto the icon bar.  To
  38. compress an Impression document directory — which must already exist on
  39. disc — drag it onto the ImpCompr icon on the icon bar.  It will be saved to
  40. a file with the same name, without the leading “!”, in the same directory as
  41. the document.
  42.  
  43. Depending on your SparkFS settings, an error such as “Not enough free
  44. memory” may be given.  In this case, you should delete the partially-created
  45. archive file and try again, after increasing SparkFS's memory setting by a
  46. suitable amount.  Due to the way that SparkFS operates, more memory is
  47. required for this initial compression operation than will be required for
  48. Impression to save into the archive later, so don't worry if it seems to
  49. need several hundred K allocated at this stage.
  50.  
  51. When this is complete, the compressed files should be ready to run:  at this
  52. stage, the original documents still exist on disc.  They can be deleted
  53. later, when you are sure that the compressed files are usable.
  54.  
  55.  
  56. Opening compressed documents
  57. ----------------------------
  58.  
  59. To open a compressed document, ensure that SparkFS is loaded then simply
  60. double-click on it in a Filer window.  It is not necessary for the ImpCompr
  61. application to be loaded, although it must have been ‘seen’ by the Filer at
  62. some point.  If it has not been seen, the standard error message “No run
  63. action specified for this file type” will be given.
  64.  
  65. Impression will then be started, if necessary, and the document loaded into
  66. it (RiscOS 2 users see below).  To save the document, simply bring up the
  67. save box and click OK;  it will be saved back into the archive.  It can also
  68. be saved to somewhere else on disc, as an uncompressed document, in the
  69. usual way.
  70.  
  71.  
  72. Notes
  73. -----
  74.  
  75. There is a slight disadvantage when using RiscOS 2, in that every time a
  76. compressed file is double-clicked to open it a new copy of Impression will
  77. be loaded.  This is due to that version of the OS not supporting the
  78. Filer_Run command;  it has to use the normal Run command which does not
  79. check whether the interested application is already loaded before starting
  80. another copy.  This could be avoided, with a bit of effort, but now that
  81. RiscOS 3 is widely available it is probably not worth fixing.
  82.  
  83. To inspect the contents of the compressed file, it can be dropped onto the
  84. SparkFS icon;  it will be stamped with the “Archive” file type (DDC).  To
  85. re-stamp it to the “ImpCompr” file type (613), drop the archive file onto
  86. the ImpCompr icon.
  87.  
  88. A document compressed in this way cannot be used for merging styles (via
  89. Impression's Edit style dialogue).  It will be necessary to open the archive
  90. file using SparkFS, then drag the document application onto the dialogue box
  91. load target.  When the operation is complete, the archive viewer should be
  92. closed and the file re-stamped as above.
  93.  
  94.  
  95. Conditions
  96. ----------
  97.  
  98. The ImpCompr application is supplied “as is”;  no responsibility is accepted
  99. for loss of data, damage to files or wasted effort arising from or connected
  100. with the use of it.  You use ImpCompr at your own risk.
  101.  
  102. The application is FreeWare, but remains copyright © myself.  It may be
  103. freely distributed by anyone (including PD libraries), on any medium
  104. (including bulletin boards), as long as no files within the application
  105. directory are altered (this includes this documentation file).  It may not
  106. be sold for profit.
  107.  
  108. Please send any bug reports or suggestions to:
  109.  
  110. Post:   11 Carmarthen Close
  111.         Farnborough
  112.         Hampshire
  113.         GU14 8TJ
  114.  
  115. E-mail: jmarten@cix.compulink.co.uk
  116. Arcade: #387
  117. Phone:  (0252) 542431
  118.  
  119. Jonathan Marten
  120. September 1992
  121.